# 워킹 디렉리

## 개요

**워킹렉터리**(Working Directory는 소프트웨어 개발, **버전관리 시스템**(Version Control System, VCS)에서 중요한 개념 중 하나입니다. 이는 개발자가 현재 작업 중인 파일들이 저장된 로컬 디렉터리(폴더)를 의미하며, 버전관리 도구가 추적하고 있는 프로젝트의 실제 파일들이 위치한 공간입니다. 가장 널리 사용되는 분산형 버전관리 시스템인 **Git**을 중심으로 설명, 워킹 디렉터리는 사용자가 코드를 수정, 추가, 삭제하는 작업을 수행하는 "현장"이라고 볼 수 있습니다.

워킹 디렉터리는 단순한 파일 저장소를 넘어, 버전관리 시스템의 다양한 상태(Staging, Commit, Repository 등)와 상호작용하는 핵심 요소입니다. 따라서 개발자가 버전관리를 효율적으로 다루기 위해서는 워킹 디렉터리의 역할과 동작 원리를 정확히 이해해야 합니다.

---

## 워킹 디렉터리의 구조와 역할

### 1. 기본 개념

워킹 디렉터리는 프로젝트의 소스 코드와 리소스 파일들이 포함된 로컬 폴더입니다. 이 디렉터리는 버전관리 시스템이 관리하는 저장소(**Repository**)의 일부로, 다음과 같은 세 가지 주요 상태 영역 중 하나입니다:

- **워킹 디렉터리 (Working Directory)**: 현재 수정 중인 파일들
- **스테이징 영역 (Staging Area / Index)**: 커밋 전에 준비된 변경 사항
- **로컬 저장소 (Local Repository)**: 커밋된 이력이 저장된 곳

예를 들어, Git을 사용할 때 프로젝트를 클론하거나 초기화하면, `.git` 디렉터리가 생성되고, 그 외의 파일들이 워킹 디렉터리에 위치하게 됩니다.

### 2. 파일 상태 관리

Git은 워킹 디렉터리 내 파일들의 상태를 다음과 같이 분류합니다:

| 상태 | 설명 |
|------|------|
| **Untracked** | Git이 아직 추적하지 않는 새 파일 |
| **Unmodified** | 이전 커밋 이후 변경되지 않은 추적 중인 파일 |
| **Modified** | 추적 중인 파일이 수정된 상태 |
| **Staged** | 수정된 파일이 스테이징 영역에 등록된 상태 |

이러한 상태 전이는 워킹 디렉터리와 버전관리 시스템 간의 상호작용을 통해 이루어지며, `git status`, `git add`, `git commit` 등의 명령어로 제어됩니다.

---

## 워킹 디렉터리의 주요 작업

### 1. 파일 수정

개발자는 워킹 디렉터리에서 자유롭게 파일을 편집할 수 있습니다. 예를 들어, 코드 에디터로 `main.py`를 열어 내용을 변경하면, 해당 파일은 **Modified** 상태가 됩니다.

```bash
# 파일 수정 후 상태 확인
git status
```

출력 예:
```
On branch main
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
        modified:   main.py
```

### 2. 변경 사항 스테이징

수정된 파일을 커밋하기 전에, `git add` 명령어를 사용해 스테이징 영역으로 옮깁니다.

```bash
git add main.py
```

이후 `git status`를 실행하면, 파일이 **Staged** 상태임을 확인할 수 있습니다.

### 3. 커밋

스테이징된 변경 사항을 `git commit`으로 로컬 저장소에 저장합니다.

```bash
git commit -m "Update main functionality"
```

이로써 워킹 디렉터리의 변경 사항이 버전 이력에 기록됩니다.

---

## 워킹 디렉터리와 버전 복원

워킹 디렉터리에서 실수로 파일을 수정하거나 삭제한 경우, 이전 상태로 되돌릴 수 있습니다. Git은 다음과 같은 명령어를 제공합니다:

### 1. 수정된 파일 되돌리기

```bash
git checkout -- main.py
```

이 명령은 `main.py` 파일을 마지막 커밋 상태로 복원합니다. **주의**: 이 작업은 되돌릴 수 없으므로 신중히 사용해야 합니다.

### 2. 삭제된 파일 복구

삭제된 파일도 이전 커밋에서 복구 가능합니다.

```bash
git checkout HEAD -- deleted_file.txt
```

---

## 워킹 디렉터리와 `.gitignore`

워킹 디렉터리 내에는 추적하지 않아야 할 파일들이 존재할 수 있습니다(예: 컴파일된 바이너리, 로그 파일, 환경 설정 파일 등). 이러한 파일들을 의도치 않게 커밋하지 않도록 하기 위해 `.gitignore` 파일을 사용합니다.

예시 `.gitignore`:
```gitignore
# 운영체제 임시 파일
.DS_Store
Thumbs.db

# 빌드 출력
/build/
/dist/

# 환경 변수
.env

# 패키지 관리자 캐시
node_modules/
__pycache__/
```

`.gitignore` 파일은 워킹 디렉터리의 루트에 위치하며, Git이 해당 패턴에 맞는 파일들을 무시하도록 지시합니다.

---

## 관련 개념

### 1. 깨끗한 워킹 디렉터리 (Clean Working Directory)

모든 변경 사항이 커밋되었거나 무시 대상인 상태를 말합니다. `git status` 명령어로 확인할 수 있으며, 다음과 같이 출력됩니다:

```
On branch main
nothing to commit, working tree clean
```

이 상태는 브랜치 전환, 풀, 푸시 등 안정적인 작업 수행에 적합합니다.

### 2. 더티 워킹 디렉터리 (Dirty Working Directory)

변경 사항이 있지만 커밋되지 않은 상태입니다. 일부 Git 작업(예: `git pull`, `git checkout`)은 더티 상태에서 실패할 수 있으므로 주의가 필요합니다.

---

## 참고 자료

- [Pro Git 2nd Edition - Git Basics](https://git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository)
- [Git Documentation - git-status](https://git-scm.com/docs/git-status)
- [Git Ignore Tutorial](https://git-scm.com/docs/gitignore)

---

## 결론

워킹 디렉터리는 버전관리 시스템에서 개발자가 직접 작업하는 공간으로, 코드 변경의 시작점이자 커밋 이전의 모든 변화가 반영되는 핵심 영역입니다. Git과 같은 도구를 사용할 때, 워킹 디렉터리의 상태를 정확히 파악하고 관리하는 것은 협업의 효율성과 코드 품질 유지에 매우 중요합니다. `.gitignore` 설정, 상태 확인, 변경 사항 스테이징 등의 습관을 기르면 보다 안정적이고 체계적인 개발 환경을 구축할 수 있습니다.